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BACKGROUND 



20 Field of the Invention 

[0001] The present invention relates to computing systems. More 
specifically, the present relates to a method and an apparatus for debugging a 
platform-independent virtual machine within a computer system. 



25 Related Art 

[0002] Computer programs written in languages such as the JAVA™ 
programming language are compiled into a platform-independent code, which is 
executed on a platform-independent virtual machine, such as a JAVA VIRTUAL 
MACHINE™ (JVM). A program that has been compiled into a platform- 

30 independent code has the advantage that it can execute on a platform-independent 
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virtual machine regardless of the underlying central processing unit and native 
code. The terms JAVA, JVM and JAVA VIRTUAL MACHINE are trademarks 
of SUN Microsystems, Inc. of Palo Alto, California. 

[0003] A platform-independent virtual machine is typically customized to 
5 fit in the memory of the computing device without adversely affecting the 

memory available for applications. For example, a platform-independent virtual 
machine on a small device such as a personal digital assistant (PDA) has few if 
any optional features while a platform-independent virtual machine on a desktop 
computer or mainframe computer may have many options and include a just-in- 

1 0 time (JIT) compiler. 

[0004] Customizing the platform-independent virtual machine for a 
different computing device is commonly termed "porting" the platform- 
independent virtual machine. Porting the platform-independent virtual machine to 
a different computing device can be difficult, particularly for a small device such 

15 as a PDA, because there are few, if any, debugging programs and devices 
available to aid in the porting process. 

[0005] Because of the lack of debugging facilities, an analyst typically 
inserts print statements into the code for the virtual machine at various places to 
try to determine the state of variables within the platform-independent virtual 

20 machine. This is a trial-and-error process, in which the analyst examines a few 
variables and then decides which other variables to examine. Each iteration 
involves changing the source code for the platform-independent virtual machine, 
recompiling the code, downloading the executable code to the target machine, and 
running the new executable code. This is a time-consuming process and detracts 

25 from the analyst's concentration in locating the problem. Additionally, inserting 
print statements into the code can affect the operation of the code in such a way 
that the problem is masked. 
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[0006] What is needed is a method and an apparatus that allows an analyst 
to view the state of variables within a platform-independent virtual machine 
without the problems listed above. 

5 SUMMARY 

[0007] One embodiment of the present invention provides a system that 
facilitates debugging a platform-independent virtual machine. The system 
operates by providing an agent on the platform-independent virtual machine, 
which provides a set of functions for accessing variables in the platform- 

1 0 independent virtual machine. The platform-independent virtual machine is then 
adapted to call the set of functions within the agent. Next, the agent examines the 
current state of the variables in the platform-independent virtual machine. The 
agent communicates the current state of the variables to a host machine. An 
operator of the host machine can then analyze the current state of the variables. 

15 [0008] In one embodiment of the present invention, the agent includes a 

core portion that is common across multiple platforms and a platform-specific 
portion for each platform. 

[0009] In one embodiment of the present invention, the platform-specific 
portion includes features and structures related to a specific platform-independent 

20 virtual machine. 

[0010] In one embodiment of the present invention, adapting the platform- 
independent virtual machine to call the set of functions within the agent involves 
inserting checkpoints within executable code for the platform-independent virtual 
machine. 

25 [0011] In one embodiment of the present invention, a checkpoint uses the 

set of functions to examine the current state of variables of the platform- 
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independent virtual machine and communicate the current state of the variables to 
the host machine 

[0012] In one embodiment of the present invention, communicating the 
current state of the variables to the host machine involves using either a direct 
coupling or a network coupling. 

[0013] In one embodiment of the present invention, the agent includes 
only mechanisms for collecting data, thereby limiting memory use of the agent on 
the platform-independent virtual machine. 

BRIEF DESCRIPTION OF THE FIGURES 

[0014] FIG. 1 illustrates computing devices coupled together in 
accordance with an embodiment of the present invention. 

[0015] FIG. 2 illustrates target machine 108 in accordance with an 
embodiment of the present invention. 

[0016] FIG. 3 illustrates host machine 104 in accordance with an 
embodiment of the present invention. 

[0017] FIG. 4 is a flowchart illustrating the process of gathering and using 
data from a target machine in accordance with an embodiment of the present 
invention. 

DETAILED DESCRIPTION 
[0018] The following description is presented to enable any person skilled 
in the art to make and use the invention, and is provided in the context of a parti- 
cular application and its requirements. Various modifications to the disclosed 
embodiments will be readily apparent to those skilled in the art, and the general 
principles defined herein may be applied to other embodiments and applications 
without departing from the spirit and scope of the present invention. Thus, the 
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present invention is not intended to be limited to the embodiments shown, but is 
to be accorded the widest scope consistent with the principles and features 
disclosed herein. 

[0019] The data structures and code described in this detailed description 
5 are typically stored on a computer readable storage medium, which may be any 
device or medium that can store code and/or data for use by a computer system. 
This includes, but is not limited to, magnetic and optical storage devices such as 
disk drives, magnetic tape, CDs (compact discs) and DVDs (digital versatile discs 
or digital video discs), and computer instruction signals embodied in a 
10 transmission medium (with or without a carrier wave upon which the signals are 
modulated). For example, the transmission medium may include a 
communications network, such as the Internet. 

Computing Devices 

15 [0020] FIG. 1 illustrates computing devices coupled together in 

accordance with an embodiment of the present invention. The system includes 
host 104 and target 108. Host 104 and target 108 can generally include any type 
of computer system, including, but not limited to, a computer system based on a 
microprocessor, a mainframe computer, a digital signal processor, a portable 

20 computing device, a personal organizer, a device controller, and a computational 
engine within an appliance. 

[0021] Host 104 and target 108 are coupled together by network 106. 
Network 1 06 can generally include any type of wire or wireless communication 
channel capable of coupling together computing nodes. This includes, but is not 

25 limited to, a local area network, a wide area network, or a combination of 

networks. In one embodiment of the present invention, network 106 includes a 
direct coupling. 
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[0022] Analyst 102 uses host 104 to install and debug a platform- 
independent virtual machine on target 108. Target 108 can include computing 
devices, which have a wide range of resources and requirements. For example, 
target 1 08 can be a personal digital assistant (PDA) with limited memory and few 
5 if any optional features. Target 108 can also be a desktop computer or mainframe 
computer and may have large quantities of available memory and many options, 
such as a just-in-time (JIT) compiler. 

[0023] Host 104 communicates with target 108 across network 106 to 
capture and display variables and data within target 108 as described below. Host 
10 104 is typically a computing device such as a desktop computer with sufficient 
resources to store the variables from target 108 and to display these variables to 
analyst 102. 

Target 108 

15 [0024] FIG. 2 illustrates target 108 in accordance with an embodiment of 

the present invention. Target 108 includes platform-independent virtual machine 
202 and agent 204, Platform-independent virtual machine 202 is a computer 
program in the native code of target 108, which can execute platform-independent 
code such as JAVA bytecode. 

20 [0025] Agent 204 is used to debug platform-independent virtual machine 

202 and includes core portion 206 and platform specific portion 208. In one 
embodiment of the present invention, agent 204 is limited to gathering the current 
state of variables within platform-independent virtual machine 202 and 
communicating the state of those variables to host 104 for display to analyst 102. 

25 Limiting agent 204 in this way reduces the memory requirements for agent 204 
and thereby allows agent 204 to be included with platform-independent virtual 
machine 202 even when target 108 has limited resources. Note that this 
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embodiment of agent 204 does not include all of the usual functions of a 
debugger, such as breakpoints, setting new values for variables, single stepping 
through the code, and the like. 

[0026] Core portion 206 includes data structures and procedures, which 

5 are common across multiple targets. These data structures include procedures for 
gathering the state of variables within platform-independent virtual machine 202 
and communicating the state of these variables to host 104. Platform specific 
portion 208 includes data structures and procedures, which are customized for the 
options and unique details of platform-independent virtual machine 202 on target 

10 1 08. Separating the agent into core portion 206 and platform specific portion 208 
is advantageous because core portion 206 remains invariant across multiple 
platforms. During porting, therefore, only platform specific portion 208 needs to 
be changed. 

[0027] Analyst 102 includes checkpoints within platform-independent 
1 5 virtual machine 202, which call functions within agent 204 to gather the current 
state of variables within platform-independent virtual machine 202 and to 
communicate the current state of these variables to host 104. A checkpoint 
identifies the variables of interest at that checkpoint. 

[0028] Following is an example of a function within platform-independent 
20 virtual machine 202, which has checkpoints included: 



25 



foo (formal parameters) :varl, var2 
{ 



checkpoint); 
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checkpoint^); 
5 : 

} 



In this example, function foo is a function within platform-independent virtual 
machine 202, which has been adapted to gather the current state of variables to be 
10 presented to analyst 102. The variables of interest in this case are varl and var2. 
Upon reaching the checkpoint instructions, the current state of these variables will 
be passed to host 104 for display. A pre-compiler makes the necessary 
adjustments to the code so that the code can be compiled by a compiler. 
[0029] Optionally, the following code can be used: 

15 

foo (formal parameters) 
{ 

20 : 

checkpoint varl, var2); 



2 5 checkpoint(var 1 , var2) ; 

} 
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In this example, the variables of interest are listed as actual parameters of the 
checkpoint instructions. 



5 Host 104 

[0030] FIG. 3 illustrates host 104 in accordance with an embodiment of 
the present invention. Host 104 includes display 302 and communication module 
304. Communication module 304 communicates with agent 204 on target 108 
across network 106 to receive the state of variables within platform-independent 
10 virtual machine 202. 

[0031] Display 302 presents these variable to analyst 102 so that analyst 
102 can determine if platform-independent virtual machine 202 is operating 
correctly, and, if not, to aid analyst 102 in determining a possible cause of the 
incorrect operation. 

15 

Analyzing Data 

[0032] FIG. 4 is a flowchart illustrating the process of gathering and using 
data in accordance with an embodiment of the present invention. The system 
starts when platform-independent virtual machine 202 encounters a checkpoint 

20 within the code (step 402). Upon encountering the checkpoint, platform- 
independent virtual machine 202 uses routines within agent 204 to gather the 
current state of variables of interest at that checkpoint (step 404). 

[0033] Next, platform-independent virtual machine 202 uses routines 
within agent 204 to communicate the current state of these variables to host 104 

25 (step 406). Finally, analyst 102 analyzes the current state of the variables using 
display 302 (step 408). 
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( 



[0034] The foregoing descriptions of embodiments of the present 
invention have been presented for purposes of illustration and description only. 
They are not intended to be exhaustive or to limit the present invention to the 
forms disclosed. Accordingly, many modifications and variations will be apparent 
5 to practitioners skilled in the art. Additionally, the above disclosure is not 
intended to limit the present invention. The scope of the present invention is 
defined by the appended claims. 
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